home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / mltplt22.zip / MANUAL.TXT < prev    next >
Text File  |  1996-07-09  |  27KB  |  761 lines
  1.             WELCOME TO MULTIPLOT/2 v1.2
  2.             ----------------------
  3.                 by
  4.                 Mike Stott
  5.                 NeoDym Systems
  6.                 15 Nesbitt St
  7.                 Nepean
  8.                 Ontario
  9.                 Canada K2H 8C4
  10.                                 July 1996
  11.  
  12.  
  13. QUICK START
  14. -----------
  15. Copy the MLTPLT22.ZIP distribution file into a convenient
  16. directory on your hard drive.  Decompress the MLTPLT22.ZIP
  17. distribution file using PKUNZIP (DOS) or UNZIP (OS2).  Get
  18. an OS/2 command prompt by opening an OS/2 window and change
  19. to the directory containing MULTIPLOT2.  Now just type:
  20.  
  21. TRYITNOW
  22.  
  23. MULTIPLOT2 should now start and open up a PM window on the
  24. desktop and show a plot of the data sets in the sample1.dat
  25. file.
  26.  
  27. Read the following documentation and enjoy using MULTIPLOT2.
  28.  
  29.  
  30.  
  31. WHAT IS MULTIPLOT/2?
  32. --------------------
  33.  
  34. Multiplot/2 is a versatile, easy to use OS/2 2.X 32 bit
  35. Presentation Manager application for manipulation and
  36. plotting of technical data sets and generation of publication
  37. quality scientific and technical line graphs.  On the same
  38. chart it can plot many sets of data to the same scale and in
  39. a variety of formats,selectable by simple menu 'click'.  The
  40. data in an individual data set can consist of any number of
  41. points (greater than zero) and the points can be at
  42. arbitrary, non-uniformly spaced intervals on the x axis.It
  43. isn't necessary to tell Multiplot/s how many items are in
  44. the data set.  It will count them for you.  Each line can be
  45. automatically plotted in a different colour and line type
  46. (i.e.  dotted, dashed etc) or fixed as solid and black.
  47.  
  48. The data can be replotted in many different combinations of 
  49. linear, logarithmic, deciBel or polar by simple menu command.
  50.  
  51. The charts are automatically scaled to accomodate the maximum
  52. range of x and y values in the data sets.  Scaling is 'sensible'
  53. and in a 1-2-5 sequence.  If you want to force a larger scale,
  54. just include two extra data sets in your data file, each with a
  55. single point in it.  These points should be the bottom left
  56. corner and the top right corner of the chart you want.
  57.  
  58. Axis labels and plot title are entered via the data file
  59. containing the numerical data.  Annotations can be added via the
  60. data file or manually and moved or re-sized in WYSIWYG fashion
  61. using the mouse.
  62.  
  63. The plotted chart is displayed in an OS/2 PM window which can be
  64. resized or reshaped using the mouse in the normal way.
  65.  
  66. Menu choices are presented in the diplay window to enable the user
  67. to direct how the program interpolates between the data points.
  68. Available choices (v1.0) are straight line,'low-pass' smoothing, 
  69. cubic spline and no interpolation i.e. only the points are 
  70. plotted with no lines in between.
  71.  
  72. The displayed chart can be copied via the clipboard to a suitable
  73. PM DTP or word processing program from which the chart can be
  74. incorporated into documents and printed.  The copying can be made
  75. as an os/2 metafile or as a bitmap.  Metafile is best as it
  76. enables the chart to be resized without loss of quality.
  77. Unfortunately os/2 and MS Windows metafiles are different and so
  78. this method can only be used with suitably equipped os/2
  79. Presentation Manager programs.  The OS/2 'Picture Viewer' is a
  80. simple way to display the metafile and print the result on the
  81. default printer. It can usually be found at \OS2\APPS\PICVIEW.EXE.
  82.  
  83. Charts copied to the clipboard in bitmap form can be pasted into
  84. os/2 PM or MS Windows programs.  Note that bitmaps exported from
  85. MULTIPLOT/2 are copies of the display window and so reflect any
  86. resizing or reshaping made to the window.  Metafiles are device
  87. independent and so do not resize or reshape with display window
  88. changes. Graphs can also be saved to disk files both in metafile 
  89. or bitmap form.
  90.  
  91. Multiplot/2 has a lot of flexibility in reading and
  92. modifying data organised in different ways.  For example in
  93. 'column' or 'row' format and with one or several 'Y'
  94. sequences corresponding to a single 'X' sequence.  It can
  95. also read data which is expressed in a recycling or modulus
  96. fashion, such as day numbers in the week or week numbers in
  97. the year.  The addition the program can be made to "filter"
  98. (i.e.  plot or not plot) a point depending on the value of
  99. the same or some other point.  Using this facility you can
  100. selectively plot points which satisfy some separate
  101. criteria.  You can also add a value to the X and/or Y data
  102. so as to offset it and plot it 'modulo' an arbitrary value.
  103. The new data thus created can be saved to disk in 'row' or
  104. 'column' format, thereby giving you the ability to transpose
  105. your data using Multiplot/2.
  106.  
  107. For users who want automated data generation and plotting
  108. environments, Multiplot/2 now has an extensive command line
  109. control capability.  Most features can be controlled from
  110. the comand line, including the ability to store the images
  111. to disk and to terminate automatically without asking for
  112. user input when finished.  This is most useful in automated
  113. unattended data generation situations where, for example, you
  114. want to run a series of programs overnight and look at the
  115. graph results next day.
  116.  
  117.  
  118.  
  119.  
  120. HOW TO USE MULTIPLOT/2
  121. ----------------------
  122.  
  123. SIMPLE OPERATION
  124.  
  125. The easiest way to run the program is to launch from the
  126. Work Place Shell.  Just display the MULTIPLOT/2 icon (for
  127. example by navigating to the directory in which Multiplot/2
  128. is located using the PM 'Drives' object) and double click on
  129. it.  You can also launch from an OS/2 command line.
  130. Navigate to the correct directory using the normal and type
  131. MLTIPLT2.  A file dialog window will pop up to enable you
  132. to select a data file for plotting.  Several example data
  133. files are included as examples.
  134.   
  135. To make your own data files, arrange your data in an ASCII
  136. text file in column format as shown below with the X and Y
  137. values on the same line, separated by spaces or tabs.
  138.  
  139. x      y  
  140. x      y  
  141. x      y  
  142. :     :
  143. :     :
  144. ***  
  145. x      y
  146. x      y  
  147. x      y 
  148. :     : 
  149. :     :
  150. ***  
  151. "X-axis label"  
  152. "Y-axis label"
  153. "Plot Title"
  154. ### 
  155.  
  156. Each group or set of X-Y pairs results in one line on the
  157. final plot chart.  You can have up to 800 points per line
  158. and up to 60 lines on the plot.  You don't have to have the
  159. same number of points in each line and you don't have to
  160. make the points uniforml y spaced along the x axis.
  161.  
  162. If you have a situation where you have several y values all
  163. corresponding to the same sequence of x values, you don't
  164. have to keep putting in the same x values over again.  You
  165. can instead put them in like this
  166.  
  167. X      y1      y2      Y3     -    - 
  168. X      y1      y2      Y3     -    - 
  169. :     :     :     : 
  170. :     :     :     : 
  171. ***  
  172. :::
  173. ###
  174.  
  175. Sometimes you get a situation where your data is arranged in
  176. rows rather than in columns.  In mathematical terms it is
  177. "transposed" -a term borrowed from matrix operations.  In
  178. this case we get all the X values on one line and all the Y
  179. values on the next l ine.  We have to tell Multiplot/2 that
  180. the data is organized in this way.  This is done by putting
  181. the keyword xytransposed before the data.  For example
  182.   
  183.  
  184. xytransposed 
  185. x      x      x      x      x      
  186. y      y      y      y      y
  187. :     :     :     :     : 
  188. :     :     :     :     :      
  189. ***  
  190. :::
  191. ###
  192.  
  193. Similarly to the column situation we can have several sets
  194. of y's corresponding to the same set of x's.  For example
  195.  
  196. xytransposed
  197. x      x      x     x       
  198. Y1      Y1      Y1      Y1       
  199. Y2      Y2      Y2      Y2       
  200. Y3      Y3      Y3      Y3       
  201. :     :     :     :
  202. :     :     :     :
  203. ***  
  204. :::
  205. ###
  206.  
  207. You can mix and match these formats in any combination.
  208. Just remember to separate each one by the three asterisks
  209. separator "***" and to finish off the whole file by a
  210. termination string "###".  The 3 label/title strings before
  211. the final "###" are optional.  If you don't put them in,
  212. Multiplot/2 will not put any labels or title on the plot.
  213.  
  214. When using a spreadsheet to generate the data, one
  215. convenient way to transfer the data to Multiplot/2 is to
  216. select columns or rows of data in the spreadsheet and to
  217. copy/paste them into an ASCII text editor such as the OS/2
  218. System Editor, E.EXE.  You can t hen add the necessary "***"
  219. lines and the axis labels, title etc.  and save the whole
  220. thing as a text file from which you can then plot.  Most
  221. sprea